home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 2 / CD ACTUAL VOL 2.iso / docs / kernel.12 / readme.000 < prev    next >
Encoding:
Text File  |  1995-09-10  |  7.9 KB  |  205 lines
  1.  
  2. ---------------------------------------------------------------------------
  3. NOTE:  See also README.arcnet-jumpers in this directory for jumper-setting
  4. information if you're like most of us and didn't happen to get a manual with
  5. your ARCnet card.
  6. ---------------------------------------------------------------------------
  7.  
  8. Since no one seems to listen to me otherwise, perhaps a poem will get your
  9. attention:
  10.             This is scary software
  11.             If it works I DO CARE.
  12.             
  13. Hmm, I think I'm allowed to call that a poem, even though it's only two
  14. lines.  Hey, I'm in Computer Science, not English.  Give me a break.
  15.  
  16. The point is:  I REALLY REALLY REALLY REALLY REALLY want to hear from you if
  17. you test this and get it working.  Or if you don't.  Or anything.
  18.  
  19. ARCnet 0.32 ALPHA first made it into the Linux kernel 1.1.80 - this was
  20. nice, but after that even FEWER people started writing to me because they
  21. didn't even have to install the patch.  <sigh>
  22.  
  23. Come on, be a sport!  Send me a success report!
  24.  
  25. (hey, that was even better than my original poem... this is getting bad!)
  26.  
  27. Anyway, enough complaining.  Let's get started:
  28.  
  29. ---------------------------------------------------------------------------
  30.             
  31. These are the ARCnet drivers for Linux.
  32.  
  33. This is the first non-ALPHA release, so please be careful, and send all
  34. possible success/failure reports to me.  If I don't know when/if/how it
  35. works, I won't be able to answer people's questions.  Do we want that?  Of
  36. course not.
  37.  
  38. Once again:  DO send me success reports!  I want to know if this is working!
  39. (You know, it might be argued that I'm pushing this point a little too much. 
  40. If you think so, why not flame me in a quick little email?  Please also
  41. include the type of card(s) you're using, software, size of network, and
  42. whether it's working or not.)
  43.  
  44. My e-mail address is:
  45.     apenwarr@tourism.807-city.on.ca
  46.  
  47.  
  48. Where do I discuss these drivers?
  49. ---------------------------------
  50.  
  51. As of the 0.22 release, we have a mailing list specifically for discussion
  52. of the ARCnet drivers for Linux, and anything you might want to interface
  53. them with (ie. DOS).  I'll also post new versions of the Linux-ARCnet
  54. distribution to the list in tar-gzip-uuencode format.
  55.  
  56. To subscribe to the list, send a message to listserv@tourism.807-city.on.ca
  57. with the following line in the BODY (not the SUBJECT) of your message:
  58.     subscribe linux-arcnet YOUR REAL NAME
  59. Remember to remove your signature, or you'll get an error back.
  60.  
  61. Send all bug (or success) reports to me or to the list.
  62.  
  63. You're free to use the comp.os.linux.development newsgroup too, but I can't
  64. guarantee I'll see it there.  (Hopefully, if my news server stays sane, I
  65. will.)
  66.  
  67. Also, SMC (one of the companies that makes ARCnet cards) has a WorldWideWeb
  68. site you might be interested in, which includes several drivers for various
  69. cards including ARCnet.  Try:
  70.     http://www.smc.com/
  71.     
  72. Novell makes a networking stack for DOS which includes ARCnet drivers.  Try
  73. ftp'ing to ftp.novell.com.
  74.  
  75. You can get the Crynwr packet driver collection (including arcether.com, the
  76. one you'll want for arcnet cards) from oak.oakland.edu:/pub/msdos/pktdrvr. 
  77. It won't work perfectly on a 386+ without patches, though, and also doesn't
  78. like several cards.  Mail me if you want a fixed version.
  79.  
  80.  
  81. Last warning:  This driver may be extremely dangerous, crash your computer,
  82. or kill your dog!  (although I'm pretty sure that I've worked that one
  83. out...)
  84.  
  85.  
  86. Loadable Module Support
  87. -----------------------
  88.  
  89. This is a new feature as of 0.42 ALPHA.
  90.  
  91. Configure and rebuild Linux.  When asked, say NO to "arcnet support" if you
  92. want loadable module support.
  93.  
  94.     make config
  95.     make dep
  96.     make clean    
  97.     make zImage
  98.     make modules
  99.     
  100.     
  101. Booting into your "ARCnet" Kernel
  102. ---------------------------------
  103.  
  104. If you're using a loadable module, you need to use insmod to load the
  105. module, and you need to specify various characteristics of your card on the
  106. command line.  For example:
  107.     cd /usr/src/linux/modules
  108.     insmod arcnet.o io=0x300 irqnum=2 shmem=0xd0000
  109. You can also add a num=1, num=2 etc for additional arcnet cards that will
  110. use arc1, arc2 etc for their device names (instead of the default, arc0).
  111.     
  112. Otherwise the driver will load and probe for your card automatically.
  113.     
  114. Now go read the NET-2-HOWTO and ETHERNET-HOWTO for Linux; they should be
  115. available where you picked up this driver.  Think of your ARCnet as a
  116. souped-up (or down, as the case may be) ethernet card.
  117.  
  118. By the way, be sure to change all references from "eth0" to "arc0" in the
  119. HOWTOs.  Remember that ARCnet isn't a "true" ethernet, and the device name
  120. is DIFFERENT.
  121.  
  122.  
  123. How do I get it to work with...?
  124. --------------------------------
  125.  
  126. NFS: Should be fine linux->linux, just pretend you're using ethernet cards. 
  127.         oak.oakland.edu:/pub/msdos/nfs has some nice DOS clients.  I can't
  128.         get SOSS (dos-based server) to work, although someone has and can't
  129.         figure out why it won't work for me.
  130.  
  131. DOS: If you're using the freeware arcether.com, you might want to install
  132.         the source code patch.  It helps with PC/TCP, and also can get
  133.         arcether to load if it timed out too quickly.  Mail me if you need a
  134.         precompiled version of arcether.com. (ie. you if don't have a DOS
  135.         assembler)
  136.     
  137. Windows:  See DOS :)
  138.  
  139. OS2: May work okay.  Please e-mail me if you find a freeware TCP/IP stack
  140.         for OS/2.
  141.         
  142. LAN Manager and Windows for Workgroups: These programs use protocols that
  143.         are incompatible with ARCnet for Linux.  Rather than using the
  144.         internet-standard ARCnet protocol, they try to pretend the cards are
  145.         ethernet, and confuse everyone else on the network.
  146.         
  147.         An upcoming release of ARCnet for Linux may have workarounds for
  148.     this stupid behaviour.
  149.  
  150.  
  151. It works: what now?
  152. -------------------
  153.  
  154. Send mail describing your setup, preferably including driver version, kernel
  155. version, ARCnet card model, CPU type, number of systems on your network, and
  156. list of software in use to me at the following address:
  157.     apenwarr@tourism.807-city.on.ca
  158.  
  159. I do send (sometimes automated) replies to all messages I receive.  My mail
  160. host is quite weird, so if you don't get a reply within a reasonable time,
  161. please resend.
  162.  
  163.  
  164. It doesn't work: what now?
  165. --------------------------
  166.  
  167. Do the same as above, but also include the output of the ifconfig and route
  168. commands, as well as any pertinent log entries (ie: anything that starts
  169. with "arcnet:" and has shown up since the last reboot) in your mail.
  170.  
  171. If you want to try fixing it yourself (I highly recommend that you mail me
  172. about the problem first, since it might already have been solved) you may
  173. want to try some of the debug levels available.  For heavy testing on
  174. DEBUG_DURING or more, it would be a REALLY good idea to kill your klogd
  175. daemon first!  DEBUG_DURING displays 4-5 lines for each packet sent or
  176. received.  DEBUG_TX and RX actually DISPLAY each packet as it is sent or
  177. received, which is obviously quite big.
  178.  
  179. You can run the arcdump shell script (available from me) as root to list the
  180. contents of the arcnet buffers at any time.  To make any sense at all out of
  181. this, you should grab the pertinent RFC's. (some are listed near the top of
  182. arcnet.c).  arcdump assumes your card is at 0xD0000.  If it isn't, edit the
  183. script.
  184.  
  185. Buffers #0 and 1 are used for receiving, and Buffers #2 and 3 are for
  186. sending.  Ping-pong buffers are implemented both ways, just to confuse you.
  187.  
  188. If your debug level is DEBUG_DURING or more, the buffers are cleared to a
  189. constant value of 0x42 every time the card is reset (which should only
  190. happen when you do an ifconfig up, or when Linux decides that the driver is
  191. broken).  This is to make it easier to figure out which bytes are being used
  192. by a packet.
  193.  
  194. You can change the debug level without recompiling the kernel by typing:
  195.     ifconfig arc0 down metric 1x
  196.     /etc/rc.d/rc.inet1
  197. where "x" is the debug level you want.  For example, "metric 14" would put
  198. you at debug level 4.  Debug level 3 is the default (D_EXTRA).
  199.  
  200.  
  201. I want to send money: what now?
  202. -------------------------------
  203.  
  204. Go take a nap or something.  You'll feel better in the morning.
  205.